home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / vbdatabs / chptrb.h < prev    next >
C/C++ Source or Header  |  1999-03-14  |  4KB  |  97 lines
  1. // ------------------------------- //
  2. // -------- Start of File -------- //
  3. // ------------------------------- //
  4. // ----------------------------------------------------------- //
  5. // C++ Header File Name: chptrb.h
  6. // Compiler Used: MSVC40, DJGPP 2.7.2.1, GCC 2.7.2.1, HP CPP 10.24
  7. // Produced By: Doug Gaer   
  8. // File Creation Date: 02/07/1997  
  9. // Date Last Modified: 03/15/1999
  10. // Copyright (c) 1997 Douglas M. Gaer
  11. // ----------------------------------------------------------- // 
  12. // ---------- Include File Description and Details  ---------- // 
  13. // ----------------------------------------------------------- // 
  14. /*
  15. The VBD C++ classes are copyright (c) 1997, by Douglas M. Gaer.
  16. All those who put this code or its derivatives in a commercial
  17. product MUST mention this copyright in their documentation for
  18. users of the products in which this code or its derivative
  19. classes are used. Otherwise, you have the freedom to redistribute
  20. verbatim copies of this source code, adapt it to your specific
  21. needs, or improve the code and release your improvements to the
  22. public provided that the modified files carry prominent notices
  23. stating that you changed the files and the date of any change.
  24.  
  25. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  26. THE ENTIRE RISK OF THE QUALITY AND PERFORMANCE OF THIS SOFTWARE
  27. IS WITH YOU. SHOULD ANY ELEMENT OF THIS SOFTWARE PROVE DEFECTIVE,
  28. YOU WILL ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR
  29. CORRECTION.
  30.  
  31. The CachePtrb class is used as a data indepentent base class for
  32. the CachePtr class. Cache pointers are used to work in conjunction
  33. with the reference counted cache buckets. Each cache pointer stores
  34. the file address of the object being poined to, a pointer to the
  35. bucket containing the memory buffer of the object, and a pointer
  36. to the cache the cache pointer is connected to.
  37.  
  38. Changes:
  39. ================================================================
  40. 09/02/1998: The Delete() function now calls the VBDFile::Remove()
  41. function instead of the VBDFile::Delete() function to de-allocate
  42. file data pointed to by the cache pointer.
  43. Changed by: Doug Gaer
  44. ================================================================
  45. */
  46. // ----------------------------------------------------------- //   
  47. #ifndef __CHPTRB_HPP__
  48. #define __CHPTRB_HPP__
  49.  
  50. #include <stddef.h>
  51. #include "int32.h"
  52.  
  53. // This typedef is defined in the vbdfile.h file
  54. #ifndef FAU
  55. typedef INT32 FAU; // (F)ile (A)ddress (U)nit, physical file address type
  56. #endif
  57.  
  58. class Bucketb; class Cacheb; // Forward class declarations
  59.  
  60. // Data independent (C)ache (P)ointer (b)ase class
  61. class CachePtrb
  62. {
  63. public:
  64.   ~CachePtrb() { Release(); }
  65.  
  66. protected:
  67.   CachePtrb(Cacheb &c, FAU p);
  68.   CachePtrb(const CachePtrb &c);
  69.  
  70. private:
  71.   void operator=(const CachePtrb &c) { }; // Disallowed
  72.  
  73. public:
  74.   void Grab() { if (!bound) Bind(); }
  75.   void Release();
  76.   void NotifyUseOf();
  77.   operator __LWORD__() const { return Address; }
  78.  
  79. protected:
  80.   void Copy(const CachePtrb &c);
  81.   Bucketb *Alloc(size_t n, FAU p=0);
  82.   void Delete(unsigned n);
  83.   void Bind();
  84.  
  85. protected:
  86.   FAU Address;   // File address of bucket data
  87.   Bucketb *bkt;  // Pointer to bucket in the cache
  88.   Cacheb *cache; // Pointer to the cache being used
  89.   char bound;    // True if pointer is bound to a bucket
  90. };
  91.  
  92. #endif // __CHPTRB_HPP__
  93. // ----------------------------------------------------------- // 
  94. // ------------------------------- //
  95. // --------- End of File --------- //
  96. // ------------------------------- //
  97.